Instructions for running ALPHA, Peer Review Edition:

System Requirements:
	Matlab/Simulink with StateFlow 2014a, should also work with later releases after library/model up-conversions.
	Also required is a compiler, for compiling the StateFlow code, see
		www.mathworks.com/support/compilers/R2014a/index.html
	
1) Launch Matlab and add REVS_Common and its subfolders to your Matlab path

2) Change your Matlab working directory to
	ALPHA Peer Review\ALPHA_standard_car
	and run run_standard_car_AT.m

		or

	run_standard_car_CVT.m

		or

	run_standard_car_DCT.m

	A series of results will be displayed in the Matlab console window.  A set of plots may be generated if the do_plots variable
	is set to true on line 4 of the run_standard_car_XXX.m script.

	In the Matlab workspace, for each simulation, r, results(r).model_data contains variables of common interest
	as collected from the various simulation raw outputs.  results(r).datalog and results(r).audit contain 
	raw model outputs and may be explored, if desired.

Background:
	The REVS_Common folder contains the core models and libraries used by ALPHA as well as helper functions
	and various scripts for processing data before and after simulation.  The libraries here are a subset of the complete
	package used for our in-house modeling efforts so it's possible one may find references to libraries or subroutines that
	are not present, e.g. hybrid or electric vehicles or alternative transmission technologies which are not part of this ALPHA release.

	REVS_Common\REVS_VM.mdl is the Simulink model file.

	Vehicle and component parameters are stored in the ALPHA_standard_car/param_files folder.

	The run_standard_car_AT package includes a baseline naturally aspirated engine and 6-speed automatic transmission.
	The run_standard_car_CVT package includes the same engine with a CVT and adds 12V start-stop functionality.
	The run_standard_car_DCT package includes a turbo-downsized engine with 8-speed DCT and an implementation of alternator regen.

	In each case, the transmission data is based on data from production units but may be in a simplified form for peer review release.
	The accessory system includes an implementation of alternator regen which can be disabled by setting 
		electric.alternator.regen_enable = false in the electric_standard_car.m param file.


Disclaimer:
	ALPHA is under active development and this release represents the state of the package at a particular
	point in time, it is subject to change without notice.  Sample input and output files are provided for reference only and
	cannot be processed by the peer review package and may not represent the production file formats.

For technical support, contact:

Kevin Newman
newman.kevin@epa.gov

